home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / utils / dupe_n25.zip / DUPENUKE.DOC < prev    next >
Text File  |  1996-05-29  |  14KB  |  307 lines
  1.                               Dupe Nukem V2.5
  2.  
  3.                           (c)1996 "Weird" Al Walker
  4.                Crazy Train ][ BBS (604)383-2201  Fidonet 1:340/88
  5.  
  6.                Internet        un109@freenet.victoria.bc.ca
  7.                  >or<          allen.walker@f88.n340.z1.fidonet.org
  8.  
  9. 0.0  Disclaimer
  10. 1.0  What is Dupe Nukem?
  11.         1.1  Why "Dupe Nukem"?
  12. 2.0  How do I use it?
  13.         2.1  Keywords
  14.         2.2  Command Line Options
  15.         2.3  ADAT2DN.EXE Maximus 2.x -> .CFG converter
  16.         2.4  File Viewer
  17. 3.0  What are all these options?
  18.         3.1  Search Criteria
  19.         3.2  Delete Preferences
  20.         3.3  Rename Only
  21. 4.0  How does it work?
  22. 5.0  How well does it work?
  23. 6.0  How do I register the Program?
  24. 7.0  Acknowledgements
  25.  
  26.  
  27. 0.0  Disclaimer
  28.  
  29.    Since this is the 90s, I think I had better put this in here...
  30.  
  31.    This program is guaranteed to take up disk space.  Beyond that I accept no
  32.  responsibility for anything. Reasonable steps have been taken to make sure
  33.  that this program will do no permanent damage to anything, and that it
  34.  functions as advertised.
  35.  
  36.  
  37. 1.0  What is Dupe Nukem?
  38.  
  39.    Dupe Nukem was originally written for someone that was fed up with all the
  40.  cross-hatching of files in the file bone, identical in every detail except for
  41.  the file area they were hatched into.  This potentially creates duplicates.
  42.  After a while, these duplicates mount up to the point where they overwhelm
  43.  available disk space.
  44.  
  45.    Another place where this program would come in handy is for those people
  46.  who might want to have lots of CD Roms online, but to save money copy them
  47.  to Hard Disk... I know of one Sysop who has 31 CD Roms online, 115,000 files,
  48.  28 Gigs of hard drive space (mostly in 4.3 Gig drives).  Dupe Nukem deleted
  49.  10,000 files (almost a Gig of files) on his system.  Now THAT'S savings!
  50.  Enough to add 2 more CDs worth of Shareware!
  51.  
  52.    How is this program different from regular duplicate file removers? Not
  53.  only does it remove the duplicates, following certain criteria, it also
  54.  removes their description from FILES.BBS, which makes it ideal for overworked
  55.  Sysops who haven't got time to go through their own file lists...
  56.  
  57.  
  58.         1.1  Why "Dupe Nukem"?
  59.  
  60.    If any of you are familiar with my VGA Planets door, you would know that
  61.  I sometimes come up with the weirdest names.  It is called "S.T.U.P.I.D.",
  62.  which stands for Simply The Ultimate Planets Interface Door...
  63.  
  64.  
  65. 2.0  How do I use it?
  66.  
  67.    This program will work with any system that uses FILES.BBS in the same
  68.  directory as the files themselves.
  69.  
  70.    To work the program you must edit DUPENUKE.CFG to reflect how your system
  71.  is set up, including the areas where your FILES.BBS and file areas are held.
  72.  The configuration file is laid out similar to other .CFG and .CTL files.
  73.  
  74.  
  75.         2.1  Keywords
  76.  
  77.  The following keywords are recognized by DUPENUKE, in DUPENUKE.CFG:
  78.  
  79. Logfile    : Name of file used to store log of what DUPENUKE has deleted
  80. Offset     : Number of spaces at the beginning of descriptions in FILES.BBS
  81. TempArea   : Path of where to put duplicate files rather than deleting them
  82. SortProgram: Name of program to use to sort the file list
  83. Area       : Path to file area - There MUST be areas for this program to work!
  84.  
  85.    More information is available in DUPENUKE.CFG...
  86.  
  87.    If you wish to have different .CFG files, say to keep groups of files
  88.  separate from each other's DUPE checking, you can specify a different .CFG
  89.  file in the command line.
  90.  
  91.         DUPENUKE NEWFILES.CFG
  92.  
  93.    When you get to the starting menu, choose the options you would like to
  94.  use by moving the flashing cursor to the option you want to toggle (cursor
  95.  keys, TAB key) and press Space to toggle the option. You can also use the
  96.  mouse to move around.  Toggle on "START" to begin processing.
  97.  
  98.  
  99.         2.2  Command Line Options
  100.  
  101. ┌──────────────────────────────────────────┬──────────────────────────────────┐
  102. │-!     Rename file instead of deleting    │ -D    Check for same file date   │
  103. │-1     Delete first duplicate found       │ -E    Check extension of file    │
  104. │-KN    Keep newest file                   │ -F    Compare files byte-by-byte │
  105. │-KND   Keep file in newest file directory │ -Z    Compare file sizes         │
  106. │-KO    Keep oldest file                   │                                  │
  107. │-KOD   Keep file in oldest file directory │ -GO   Start Non-Interactive Mode │
  108. ├──────────────────────────────────────────┴──────────────────────────────────┤
  109. │ -C...  Set Config file to "..." (instead of default "DUPENUKE.CFG")         │
  110. │ -L...  Set Log file to "..." (Default is no logging)                        │
  111. │ -O##   Set Offset to ## (See DUPENUKE.DOC for details)                      │
  112. │ -R...  Turn on Report Only Mode ("..." is report file to use,               │
  113. │                            default to "DUPENUKE.RPT" if just "-R" is used)  │
  114. │ -S...  Set sort program to "..."  (ie -Sksort.exe = "KSORT.EXE")            │
  115. │ -T...  Set Temporary storage area to "..."                                  │
  116. └─────────────────────────────────────────────────────────────────────────────┘
  117.  
  118.         2.3  ADAT2DN.EXE Maximus -> .CFG converter
  119.  
  120.    This program will allow people using Maximus 2.x to create a "quicky" area
  121.  list for the .CFG file...   You run it thusly:
  122.  
  123.         ADAT2DN {path to AREA.DAT} >>DUPENUKE.CFG
  124.  
  125.   (The ">>" will append the output of ADAT2DN to the end of DUPENUKE.CFG, and
  126.    you can then delete the areas in that list that you don't want checked...)
  127.  
  128.     If anyone can send me a FAREA.DAT or whatever from Max3, I will make a
  129.         converter for that too....
  130.  
  131.  
  132.         2.4  File Viewer
  133.  
  134.    For this version, I have implemented a file viewer, configurable to be
  135.  used to view/display almost any type of file, including viewing archive
  136.  contents, playing .WAV & .VOC files, and viewing .JPG, .GIF & whatever
  137.  other type of file you have something that will view them with.  This is
  138.  done by checking through the .CFG file for a corresponding extension, and
  139.  running the proper viewer/archiver depending on the extension.
  140.  
  141.  For example:
  142.  
  143.         View ZIP "pkunzip -v"
  144.  
  145.     in the .CFG file will look for any file with a "ZIP" extension, and run
  146.  "PKUNZIP -V" filename, then allow you to view the results.
  147.  
  148.         View GIF "qpeg"
  149.  
  150.     in the .CFG will run "QPEG" filename, viewing the file.
  151.  
  152.    If the extension is not found in the "View" list in the .CFG, the file will
  153.  be assumed to be a plain asc file, and viewed with the built in text viewer.
  154.  
  155.      NOTE:  If the program you are running needs a key pressed to continue
  156.  (like QPEG needs a space at the beginning and end of the run), you will need
  157.  to press it, un-prompted... The output of the program is being redirected
  158.  to a file to be read by the built in viewer, and you won't be able to see
  159.  it's prompt, but it will still be waiting for the key...
  160.  
  161.  
  162. 3.0  What are all these options?
  163.  
  164.    Dupe Nukem allows you to use a set of criteria to decide what is and isn't
  165.  a duplicate file.  It also allows you to configure the program to choose
  166.  which duplicate you want to delete when one is found.  The options are as
  167.  follows:
  168.  
  169. Options: ( ) Interactive         Delete Preferences: ( ) Delete First
  170.          ( ) Non-Interactive                         ( ) Keep Oldest File
  171.          ( ) Report Only                             ( ) Keep Newest File
  172.                                                      ( ) Keep Oldest Dir
  173. Search Criteria: ( ) Check Size                      ( ) Keep Newest Dir
  174.                  ( ) File Date Same                  ( ) Rename Duplicate
  175.                  ( ) Compare Files                   ╔═══════╗
  176.                  ( ) Extension                       ║ START ║
  177.                                                      ╚═══════╝
  178.  
  179. Interactive mode: Allows you to pick and choose which duplicate files
  180.                   will be removed.
  181.  
  182. Report Only: Will only generate a report (DUPENUKE.RPT) of what this
  183.              program WOULD have deleted.
  184.  
  185.  
  186.         3.1  Search Criteria
  187.  
  188.    These are used to determine what files are duplicates.
  189.  
  190. Check Size: Compare the sizes of the 2 files.
  191.  
  192. File Date Same: Compares the Date of the 2 files. If the same then they
  193.                 are presumed dupes.
  194.  
  195. Compare Files: Does a Byte-By-Byte compare of the files.  If they match
  196.                they are DEFINITELY duplicate files...
  197.  
  198. Extension: Compares the .EXT of the files (ie: FIRE.TXT and FIRE.ASC may
  199.            in fact be dupes of each other, but with Extension on, they
  200.            won't be found.
  201.  
  202.  
  203.         3.2  Delete Preferences
  204.  
  205.    This determines which file will be removed in non-interactive mode.
  206.  
  207. Delete First: Deletes first of 2 files found to be dupes.
  208.  
  209. Keep Oldest/Newest: Keeps the Oldest/Newest of the 2 dupes. If the dates
  210.                     match, file is deleted according to "Delete First".
  211.  
  212. Keep Oldest/Newest Directories: Will delete dupes according to how old
  213.                                 the directory they are in (in days) is.
  214.                                 This should protect CD's that you have
  215.                                 installed later than others.
  216.  
  217. Rename Duplicate: Renames root of filename to a unique filename, usually by
  218.                   either adding a "!" to the name (if less than 8 characters)
  219.                   or by changing the last character (if 8 characters long
  220.                   already).  This will not do anything to the Extension.
  221.  
  222.    Most of the Delete Preferences are mutually exclusive, so turning one on
  223.  turns off the rest. If no options are highlighted, the second duplicate found
  224.  is deleted (Default Setting).
  225.         
  226.         3.3  Rename Only
  227.  
  228.    Some files are duplicates in name only... On very LARGE systems, one might
  229.  find a large number of "name-only" duplicates, who's only problem is that
  230.  they have the same name.  A game with the same name as a .ZIPped Text File...
  231.  
  232.    This usually causes a problem for systems that have a "Global" file tagging
  233.  capability, and give you the first matching file, whether it's the one you
  234.  want or not.
  235.  
  236.    If you use Rename Only mode, the offending file will be renamed, both in the
  237.  directory & in the FILES.BBS entry for it.  This usually means adding a "!"
  238.  to the end of the root (first 8 characters, before the ".") of the filename,
  239.  but could also mean changing the last character (TEXTFILE.ZIP would become
  240.  TEXTFIL!.ZIP).  This rename feature then checks to make sure it's not creating
  241.  a whole new name-duplication problem, by quickly checking the whole list. (If
  242.  "!" were already used, it would try numbers, letters, then a couple of weird
  243.  symbols).
  244.  
  245.  
  246. 4.0  How does it work?
  247.  
  248.    First, all of the filenames in each FILES.BBS are read and stored, along with
  249.  the path (the actual directories are not read, so only those files found *in*
  250.  the FILES.BBS will be searched/sorted).  Then all the files are sorted in
  251.  alphabetical order.  This file is then read, comparing each filename with
  252.  the next one in the list.
  253.  
  254.    If a duplicate filename is found, then other criteria are checked, such as
  255.  file size, file date, and actual byte-by-byte comparisons (all configurable
  256.  from the main menu, or command line).
  257.  
  258.    If the file is definitely a dupe, the file(s) are either put up on the
  259.  screen (interactive mode), or one is deleted automatically (non-interactive
  260.  mode) or written to a report file depending on the options selected. If you
  261.  choose to delete the file, the file is removed, along with the description
  262.  found within FILES.BBS...
  263.  
  264.  
  265. 5.0  How well does it work?
  266.  
  267.    I tried the program on a system with 115,000 files (31 Shareware CD-Roms),
  268.  and the program found approximately 10,000 duplicates, adding up to almost a
  269.  *Gigabyte* of space saved.
  270.  
  271.  
  272. 6.0  How do I register the Program?
  273.  
  274.    Fill out and mail the registration form (REG-FORM.TXT), along with a check
  275.  or M.O. to:
  276.  
  277.                         Allen Walker
  278.                         P.O. Box 5874
  279.                         Victoria, B.C. Canada
  280.                         V8R 6S8
  281.  
  282.    If you wish to pay by Visa, be sure to completely fill out the information
  283.  in the registration form, and your Key will be sent within 24 hours of reciept
  284.  of your form.
  285.  
  286.  
  287. 7.0  Acknowledgements
  288.  
  289.  Many thanks to:    Joe Patterson - For the original Idea, for being the first
  290.                                 registered user, and for proofreading the docs!
  291.                     John Bernard  - For allowing me to run my program on his
  292.                                 system after just meeting me, and putting up
  293.                                 with my debugging the DeleteFiles.BBS_Desc
  294.                                 code on the fly (It worked fine on my system!)
  295.                     Gerald Albion - The other half & founding father of
  296.                                 Whirlwind Software - For introducing me to
  297.                                 John, and some good ideas...
  298.  
  299.  
  300.  
  301.   ▀█▄     ▀█▄ ▀█▄  ▀█▄ ▀█▄ ▀███▀▀█▄  ▀█▄    ▀█▄     ▀█▄ ▀█▄ ▀██▄  ▀█▄ ▀██▀▀█▄
  302.    ██ ▄██ ▄██ ▐██▄▄▐██ ▐██ ▐██  ▄██  ▐██     ██ ▄██ ▄██ ▐██ ▐████▄▐██ ▐██  ▐██
  303.    ████████▀  ██▌▀▀██▌ ██▌ ██▀███▀   ██▌     ████████▀  ██▌ ██▌ ▀███▌ ██▌   ██
  304.   ▄██▀ ██▀   ▐██  ▐██ ▐██ ▐█▌  ▀██▄ ▐██▄▄▄▄ ▄██▀ ██▀   ▐██ ▐██   ▐██ ▐██▄▄▄██▀
  305.  
  306.    This is another fine software product of Whirlwind Software, Victoria, B.C.
  307.